﻿========================================================================
  Excel はんこアドイン  Version 1.0.0
========================================================================

  ソフト名     : Excel はんこアドイン
  バージョン   : 1.0.0
  作 者        : highdefinitionaudiodriver
  動作環境     : Windows 10/11, macOS 12+, Linux (Ubuntu 20.04+) / Node.js 20 以上
  ライセンス   : MIT License（フリーソフト／オープンソース）
  種 別        : フリーソフト
  作成日       : 2026-06-03

------------------------------------------------------------------------
■ ソフトの説明 / 使用方法（README より）
------------------------------------------------------------------------

Excel Hanko Add-in - 電子印鑑（データ印）

日本式の電子印鑑（データ印）を Excel に挿入する Office Web アドインです。
Excel Online（Web版）およびデスクトップ版 Excel の両方で動作します。

---

🎯 これは何？（30秒で）

- 誰のため：脱ハンコを進めたい中小企業／在宅勤務で書類押印が手間な総務・経理担当
- 何が解決される：紙の書類に印鑑を押すために出社・郵送する非効率を、Excel ファイル内でワンクリック押印に置き換える。日付・部署・氏名を含む日本式データ印を Canvas で動的生成し PNG として挿入
- なぜ既存ツールではダメか：商用電子印鑑サービスは法人課金が前提。本ツールは Office Web アドインとして無料配布可能で、AppSource 経由で組織にも個人にも展開できる
- 使う条件：Excel Online または Excel デスクトップ版 (Microsoft 365)

💰 想定ユースケース・価格帯

| 用途 | 形態 |
|---|---|
| 個人利用 | 無料（MIT） |
| 法人利用（証跡 CSV エクスポート・部署一括展開・印影バリエーション） | 今後の有料機能として検討 |
| カスタマイズ・社内テンプレ統一・SSO 連携 | 応相談 |


🎬 デモ

<!-- docs/demo.gif に「アドイン起動 → 印影設定 → Excel/Word/PowerPointへの押印 → 証跡CSVエクスポート」までの30秒デモGIFを配置してください。 -->

機能

- 丸型の日本式データ印（電子印鑑）を Canvas で動的生成
- 上段（苗字）・中段（日付）・下段（部署名等）の3段構成
- リアルタイムプレビュー付きの作業ウィンドウ UI
- ワンクリックでアクティブセルの位置に PNG 画像として挿入
- 日付は今日の日付を自動入力（YYYY/MM/DD 形式）
- 押印ごとにユニークなトラッキングID を自動付与（簡易証跡機能）

印鑑デザイン


    ╭──────────╮
   │   山 田    │  ← 上段: 苗字など
   │──────────│
   │ 2026/04/05 │  ← 中段: 日付
   │──────────│
   │   営業部   │  ← 下段: 部署名（空欄可）
    ╰──────────╯
                a3f1b20e  ← トラッキングID（極小グレー文字）


- 外枠: 赤い円（丸型）
- 区切り: 円の弦による横線で3分割
- 文字色: すべて赤色
- フォントサイズ: 領域に合わせて自動調整
- トラッキングID: 円の右下に8桁の16進数を極小グレー文字で描画

トラッキング機能

「押印」ボタンを押すたびに、crypto.getRandomValues で8桁のランダムな16進数ID（例: a3f1b20e）を生成します。

- ID は印鑑画像の右下にグレーの極小文字（8px）で埋め込まれる
- 押印完了後、ステータスバーにも ID が表示される（例: 押印しました (ID: a3f1b20e)）
- プレビューには ID は表示されず、実際の押印時のみ付与される
- 見た目上のシリアルナンバーとして、どの印影がいつ生成されたかの簡易的な証跡になる

テクノロジースタック

| 技術 | 用途 |
|---|---|
| HTML / CSS | 作業ウィンドウ UI |
| JavaScript | 印鑑描画ロジック・Office.js 連携 |
| HTML5 Canvas | 印鑑画像の動的生成 |
| Office.js (Excel.js API) | Excel へのシェイプ（画像）挿入 |
| Web Crypto API | トラッキングID の乱数生成 |
| Node.js / http-server | ローカル HTTPS 開発サーバー |

AppSource 審査前チェック

- manifest.xml の URL は GitHub Pages 公開先（https://highdefinitionaudiodriver.github.io/excel-hanko-addin/）を想定
- GitHub Pages は main ブランチのリポジトリルート公開に設定
- 現状のアイコンはプレースホルダ。AppSource提出前に 16/32/80px と高解像度アイコンを正式PNGへ差し替え
- サポートURLは GitHub Issues、プライバシーポリシーはリポジトリREADME/SECURITYから提出画面に登録

プロジェクト構成


excel-hanko-addin/
├── manifest.xml          # Office アドインマニフェスト
├── package.json          # 依存関係・起動スクリプト
├── README.md
└── src/
    ├── taskpane.html     # 作業ウィンドウ UI
    ├── taskpane.js       # 印鑑生成 & Excel 挿入ロジック
    └── assets/
        └── icon-32.png   # リボンアイコン


セットアップ

前提条件

- [Node.js](https://nodejs.org/) v18 以上
- Microsoft 365 アカウント（Excel Online を使用する場合）

インストール


git clone https://github.com/<your-username>/excel-hanko-addin.git
cd excel-hanko-addin
npm install


開発サーバーの起動


npm start


初回起動時に office-addin-dev-certs が自己署名 SSL 証明書を自動生成・インストールします。
Windows の場合、証明書の信頼ダイアログが表示されたら「はい」を選択してください。

サーバーが起動すると https://localhost:3000 でアクセス可能になります。

> Note: npm start の証明書パスは環境に合わせて package.json 内の scripts.start を編集してください。

Excel Online へのサイドロード

1. [office.com](https://office.com) で Excel Online を開く
2. 挿入 タブ → アドイン → マイ アドイン
3. カスタム アドインのアップロード をクリック
4. プロジェクト内の manifest.xml を選択してアップロード
5. ホームタブに「押印」ボタンが表示される

デスクトップ版 Excel へのサイドロード (Windows)

1. 任意の場所にマニフェスト共有フォルダを作成（例: C:\AddinManifests）
2. manifest.xml をそのフォルダにコピー
3. Excel → ファイル → オプション → トラスト センター → トラスト センターの設定
4. 信頼できるアドイン カタログ にフォルダパスを追加
5. Excel を再起動 → 挿入 → アドイン → 共有フォルダ から「電子印鑑」を追加

使い方

1. アドインの作業ウィンドウが開いたら、各欄に入力:
   - 上段: 苗字など（例: 山田）
   - 中段: 日付（今日の日付が自動入力済み）
   - 下段: 部署名など（空欄可）
2. プレビューで印鑑の見た目を確認
3. Excel 上で挿入先のセルを選択
4. 「押印」 ボタンをクリック
5. 選択セルの位置に印鑑画像が挿入される（トラッキングID 付き）
6. ステータスバーに挿入結果と ID が表示される

カスタマイズ

src/taskpane.js 内の定数を変更することで、印鑑のサイズや色を調整できます:


const STAMP_SIZE = 200;            // Canvas 描画解像度 (px)
const INSERT_SIZE_PX = 60;         // Excel 挿入サイズ (px)
const STAMP_COLOR = "#c62828";     // 印鑑の色（赤）
const TRACKING_COLOR = "#aaaaaa";  // トラッキングID の文字色（グレー）
const TRACKING_FONT_SIZE = 8;      // トラッキングID の文字サイズ (px)


API 要件

このアドインは以下の Excel JavaScript API を使用します:

- Excel.run() — バッチ処理コンテキスト
- Workbook.getSelectedRange() — 選択セルの取得
- Worksheet.shapes.addImage() — 画像シェイプの挿入（要件セット: ExcelApi 1.9 以上）

ライセンス

MIT

---

🤝 商用利用・カスタマイズ依頼

- 個人利用は無料（MIT ライセンス）
- 法人導入支援、カスタマイズ、業務テンプレ整備、追加機能開発は応相談
- 連絡先：highdefinitionaudiodriver@gmail.com

<!-- CODEX-CURRENT-STATUS:START -->
現状サマリ (2026-05-25)

- 対象: Excel Hanko Add-in - 電子印鑑（データ印）
- 作業ブランチ: feat/sellable-v1
- README更新時点の参照コミット: 86f0ae9 docs: AppSource向けmanifest URLとデモ導線を整備（Office実機未検証）
- Node.js / JavaScript 系プロジェクト。package.json を起点に依存関係とスクリプトを管理。
- docs ディレクトリ配下に設計・運用・補足資料を配置。
- src ディレクトリ配下に主要実装を配置。
- 主要な確認コマンド: npm test / npm run check（定義がある場合）
- 次に進めるなら、README 内の利用手順と既存 docs / tests を起点に、未整備の検証手順・引き継ぎメモ・CI 化を補強する。
<!-- CODEX-CURRENT-STATUS:END -->

------------------------------------------------------------------------
■ 動作環境
------------------------------------------------------------------------
  Windows 10/11, macOS 12+, Linux (Ubuntu 20.04+) / Node.js 20 以上
  ※ オンライン専用ソフトではありません（ローカル環境で動作します）。

------------------------------------------------------------------------
■ インストール / アンインストール
------------------------------------------------------------------------
  ・本アーカイブを任意のフォルダに展開してください。
  ・詳細な起動手順は上記「ソフトの説明」および同梱の README を参照してください。
  ・アンインストールは展開したフォルダを削除するだけです（レジストリ不使用）。

------------------------------------------------------------------------
■ 転載・再配布について
------------------------------------------------------------------------
  本ソフトは MIT License のオープンソースです。同梱の LICENSE 条文に
  従う限り、自由に利用・改変・再配布できます。
  なお Vector 以外の配布サイトへの無断転載はご遠慮ください。

------------------------------------------------------------------------
■ 免責事項
------------------------------------------------------------------------
  本ソフトの使用によって生じたいかなる損害についても、作者は一切の
  責任を負いません。利用者ご自身の責任においてご使用ください。

------------------------------------------------------------------------
■ 著作権
------------------------------------------------------------------------
  Copyright (c) 2026 highdefinitionaudiodriver
  本ソフトは MIT License の下で公開されています。

------------------------------------------------------------------------
■ 連絡先 / サポート
------------------------------------------------------------------------
  作 者        : highdefinitionaudiodriver
  E-mail       : highdefinitionaudiodriver@gmail.com
  GitHub       : https://github.com/highdefinitionaudiodriver/excel-hanko-addin.git
  不具合報告・ご要望は上記 E-mail もしくはリポジトリの Issues へ
  お願いいたします。

========================================================================
